Sourced from @​notionhq/client's releases.

v4.0.1

What's Changed

• Support additional headers passed to notion.request()

Full Changelog: makenotion/notion-sdk-js@f7bfcfd...v4.0.1

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/4.0.1

v4.0.0

What's Changed

• Remove no-op duplicates from union types across all endpoints by @​ksinder in makenotion/notion-sdk-js#579
• Remove legacy (<=2021) v1 API shape for page properties by @​ksinder in makenotion/notion-sdk-js#580
  • Removes support for the legacy (pre-Q3-2021) shape for page properties parameters from CreatePageBodyParameters and UpdatePageBodyParameters in src/api-endpoints.ts.
  • This collapses the union type of {old properties shape, new properties shape} down to the new shape only.
  • In the old shape, properties was a fairly ambiguous Record<string, ...> mapping each property key to the property value (a union type across all possible property types' values) e.g.

    {
      // ...
      "numberId": 24,
    }

  • In the new shape (the only one we want to support going forward), the value must be wrapped in an object that uses the polymorphic type pattern with the actual value defined in a sub-object to disambiguate:

    {
      // ...
      "numberId": {
        "type": "number",
        "number": 24
      }
    }

  • This matches up with our responses in the API read path so most, if not all, integrations are likely already using syntax compatible with the new shape
• chore: add JSDoc comments to API types by @​julyou in makenotion/notion-sdk-js#585
• Add support for attachments in Comment API by @​julyou in makenotion/notion-sdk-js#586
• CreatePage: support workspace-level private pages (+ misc param type refactors) by @​ksinder in makenotion/notion-sdk-js#587
  • No-op refactors/cleanups: extracting some components into separate type aliases, e.g. AnnotationRequest
  • Support the new mode in POST /v1/pages (CreatePage) API where:
    • parent can be omitted, or passed as {"workspace": true}, to create top-level private pages at the workspace level (for public integrations only)
    • properties is also optional. For standalone pages, this results in title defaulting to an empty string
• Sync API endpoints: add display_name to Comment, more extraction refactors and docstrings by @​ksinder in makenotion/notion-sdk-js#588
  • This includes miscellaneous extraction refactors for named subsets of parameters and other cleanups like new parameter docstrings.
  • The only functional change is adding the new display_name object to the CommentObjectResponse, and some fixes from previous PRs around parenthesizing a & (b | c) in allOf → oneOf OpenAPI types to get the correct result rather than defaulting to the incorrect interpretation (a & b) | c.
• Sync latest API endpoints schema as of 2025-06-30 by @​ksinder in makenotion/notion-sdk-js#590
  • Most of these are no-op re-ordering of type definitions.
  • Some added and edited comments/docstrings.
  • The only semantic change is adding support for the abc music language to LanguageRequest.

... (truncated)

• 14a039a 4.0.1
• 037faa3 Support additional headers to notion.request
• f7bfcfd Major version bump: v3.1.3 → v4.0.0 (#592)
• 26d7568 Include comment display name and file upload in intro API example (#591)
• 103125a Sync latest API endpoints schema as of 2025-06-30 (#590)
• a09fc0e Sync API endpoints: add display_name to Comment, more extraction refactor...
• 838db2e CreatePage: support workspace-level private pages (+ misc param type refactor...
• 01809c7 Add support for attachments in Comment API (#586)
• 8ac672b chore: add JSDoc comments to API types (#585)
• 7f52865 Remove legacy (<=2021) v1 API shape for page properties (#580)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)